Skip to main content

task message_loop

Command Title​

/task message_loop

Description​

This command allows you to set up a message count-based loop task rewards users for sending a certain number of messages within a specified time period in designated channels.

Usage​

/task message_loop <reward> <messages> [interval] [period] [limit] [channel]

Parameters​

Required Parameters:​

  • <reward>: This must be a positive integer or 0. Setting 0 will disable the reward. It represents the number of points awarded each time the message count requirement is met.
  • <messages>: This must be a positive integer representing the number of messages required to trigger a reward.

Optional Parameters:​

  • [interval]: The minimum interval (in minutes) between each message to be counted towards the reward. If omitted, defaults to 2.
  • [period]: The time period for the task. It can be set to Daily, Weekly, Monthly, or Lifetime (no time limit). If omitted, defaults to Lifetime.
  • [limit]: The maximum number of times a user can receive a reward within a given period. If omitted, defaults to Unlimited.
  • [channel]: If omitted, all channels are included. If specified, only messages in the selected channel are counted.

Examples​

  • Example 1: Set up a task that rewards 10 points every time a user sends 5 messages (with at least 2 minutes interval between each message) in any channel, with no period or reward limit.

    /task message_loop reward:5 messages:10

  • Example 2: Set up a task that rewards 3 points every time a user sends 20 messages (with at least 2 minutes interval between each message) in any channel, with a maximum of 5 rewards per day.

    /task message_loop reward:3 messages:20 limit:5 period:Daily

  • Example 3: Set up a task that rewards 2 points every time a user sends 15 messages (with at least 5 minutes interval between each message) in the #general channel, with no period or reward limit.

    /task message_loop reward:2 messages:15 interval:5 channel:#general

  • Example 4: To delete this task, simply set the reward to 0 and the message count to 1.

    /task message_loop reward:0 messages:1

Notes​

  • Only one message count-based loop task can be set per server. If a task already exists, the new settings will overwrite the old ones.
  • The reward is granted once the message count is reached within the specified period.

FAQs​

  • Q: Can I change the reward value or message count after setting up the task?

    • A: Yes, you can use the same command with updated parameters to modify the task.

  • Q: Can I have multiple message count-based loop tasks?

    • A: No, only one message count-based loop task can run per server.